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ABSTRACT 

This document describes briefly the changes in the Berkeley system for the VAX 
between the 4.1BSD distribution of April 1981 and this, its revision of July 1983. It 
attempts to summarize, without going into great detail, the changes which have been 
made. 


Notable improvements 

The file system organization has been redesigned to provide at least an order of magnitude 
improvement in disk bandwidth. 

The system now provides full support for the DOD Standard TCP/IP network communication proto- 
cols. This support has been integrated into the system in a manner which allows the development 
and concurrent use of other communication protocols. Hardware support and routing have been iso- 
lated from the protocols to allow sharing between varying network architectures. Software support is 
provided for 10 different hardware devices including 3 different 10 Mb/s Ethernet modules. 

A new set of interprocess communication facilities has replaced the old multiplexed file mechanism. 
These new facilities allow unrelated processes to exchange messages in either a connection-oriented 
or connection-less manner. The interprocess communication facilities have been integrated with the 
networking facilities (described above) to provide a single user interface which may be used in con- 
structing applications which operate on one or more machines. 

A new signal package which closely models the hardware interrupt facilities found on the VAX 
replaces the old signals and jobs library of 4.1BSD. The new signal package provides for automatic 
masking of signals, sophisticated signal stack management, and reliable protection of critical regions. 

File names are now almost arbitrary length (up to 255 characters) and a new file type, symbolic link, 
has been added. Symbolic links provide a “symbolic referencing” mechanism similar to that found 
in Multics. They are interpolated during pathname expansion and allow users to create links to files 
and directories which span file systems. 

The system supports advisory locking on files. Files can have “shared” or “exclusive” locks applied 
by processes. Multiple processes may apply shared locks, but only one process at any time may have 
an exclusive lock on a file. Further, when an exclusive lock is present on a file, shared locks are dis- 
allowed. Locking requests normally block a process until they can be completed, or they may be 
indicated as “non-blocking” in which case an error is returned if the lock can not be immediately 
obtained. 



The group identifier notion has been extended to a “group set”. When users log in to the system 
they are placed in all their groups. Access control is now done based on the group set rather than just 
a single group id. This has obviated the need for the newgrp command. 

Per-user, per-filesystem disk quotas are now part of the system. Soft and hard limits may be specified 
on a per user and per filesystem basis to control the number of files and amount of disk space allo- 
cated to a user. Users who exceed a soft limit are warned and if, after three login sessions, their disk 
usage has not dropped below the soft limit, their soft limit is treated as a hard limit. Utilities exist for 
the creation, maintenance, and reporting of disk quotas. 

System time is now available in microsecond precision and millisecond accuracy. Users are provided 
with 3 high-resolution timers which may be set up to automatically reload on expiration. The timers 
operate in real time, user time, and process virtual time (for profiling). All statistics and times 
returned to users are now given in a standard format with seconds and microseconds separated. This 
eliminates program dependence on the line clock frequency. 

A new system call to rename files in the same file system has been added. This call eliminates many 
of the anomalies which could occur in older versions of the system due to lack of atomicity in remov- 
ing and renaming files. 

A new system call to truncate files to a specific length has been added. This call improves the perfor- 
mance of the Fortran I/O library. 

Swap space configuration has been improved by allowing multiple swap partition of varying sizes to 
be interleaved. These partitions are sized at boot time to minimize configuration dependencies. 

The Fortran 77 compiler and associated I/O library have undergone extensive changes to improve 
reliability and performance. Compilation may, optionally, include optimization phases to improve 
code density and decrease execution time. 

A new symbolic debugger, dbx, replaces the old symbolic debugger sdb. Dbx works on both C and 
Fortran 77 programs and allows users to set break points and trace execution by source code line 
numbers, references to memory locations, procedure entry, etc. Dbx allows users to reference struc- 
tured and local variables using the program’s programming language syntax. 

The delivermail program has been replaced by sendmail. Sendmail provides full internetwork rout- 
ing, domain style naming as defined in the DARPA Request For Comments document #833, and 
eliminates the compiled in configuration database previously used by delivermail. Further, sendmail 
uses the DARPA standard Simple Mail Transfer Protocol (SMTP) for mail delivery. 

The system contains a new line printer system. Multiple line printers and spooling queues are sup- 
ported through a printer database file. Printers on serial lines, raster printing devices, and laser print- 
ers are supported through a series of filter programs which interface to the standard line printer “core 
programs”. A line printer control program, lpc, allows printers and printer queues to be manipulated. 
Spooling to remote printers is supported in a transparent fashion. 

Cu has been replaced by a new program tip. Tip supports a number of auto-call units and allows des- 
tination sites to be specified by name rather than phone number. Tip also supports file transfer to 
non-UNIX machines and can be used with sites which require half-duplex and/or odd-even parity. 

Uucp now supports many auto-call units other than the DN11. Spooling has been reorganized into 
multiple directories to cut down on system overhead. Several new utilities and shell scripts exist for 
use in adminstrating uucp traffic. Operation has been greatly improved by numerous bug fixes. 
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Bug fixes and changes 

Section 1 


adb Support has been added for interpreting kernel data structures on a running system and in post 

mortem crash dumps created by savecore. A -k option causes adb to map addresses accord- 
ing to the system and current process page tables. A new command, $p, can be used to switch 
between process contexts. Many scripts are available for symbolically displaying kernel data 
structures, searching for a process’ context by process ID, etc. A new document, “Using 
ADB to Debug the UNIX Kernel”, supplies hints in the use of adb with system crash dumps. 

addbib Is a new utility for creating and extending bibliographic data bases for use with refer, 

apply Is a new program which may be used to apply a command to a set of arguments. 

ar Has a new key, ‘o’, for preserving a file’s modification time when it is extracted from an 

archive. 


cc Supports the additional symbol information used by dbx. The old symbol information, used 

by the defunct sdb debugger, is available by specifying the -go flag. A new flag, -pg, creates 
executable programs which collect profiling information to be interpreted by the new gprof 
program. A bug in the C preprocessor, which caused line numbers to be incorrect for macros 
with formal parameters with embedded newlines has been fixed. The C preprocessor now 
properly handles hexadecimal constants in “#if” constructs and checks for missing “#endif” 
statements. 

chfn Now works interactively in changing a user’s information field in the password file. 

chgrp Is now in section 1 and may be executed by anyone. Users other than the super-user may 

change group ownership of a file they own to any group in their group access list. 

cp Now has a -r flag to copy recursively down a file system tree. 

csh A bug which caused backquoted commands to wedge the terminal when interrupted has been 

fixed. Job identifiers are now globbed. A bug which caused the “wait” command to unin- 
teruptible in certain cases has been fixed. History may now be saved and restored across ter- 
minal sessions with the savehist variable. The newgrp command has been deleted due to the 
new group facilities. 

ctags Now handles C typedefs. 

cu Exists only in the form of a “compatible front-end” to the new tip program. 

dbx Is a new symbolic debugger replacing sdb. Dbx handles C and Fortran programs. 

delivermail 

Has been replaced by the new sendmail program. 

df Understands the new file system organization and reports all disk space totals in kilobytes. 

du Now reports disk usage in kilobytes and uses the new field in the inode structure which con- 

tains the actual number of blocks allocated to a file to increase accuracy of calculations. 

dump Has been moved to section 8. 

error Has been taught about the error message formats of troff. 

eyacc A bug which caused the generated parser to not recognize valid null statements has been 

fixed. 


f77 Has undergone major changes. 

The i/o library has been extensively tested and debugged. Sequential files are now opened at 
the BEGINNING by default; previously they were opened at the end. 

Compilation of data statements has been substantially sped up. Significant new optimization 
is optionally available (this is still a bit buggy and should be used with caution). Even 
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without optimization, however, single precision computations execute much faster. 

The new debugger, dbx, has replaced sdb for debugging Fortran programs; sdb is no longer 
supported. 

Files with “.F” suffixes are preprocessed by the C preprocessor. This allows C-style 
“#include” and “#define” constructs to be used. The compiler has been modified to print 
error messages with sensible line numbers. Make also understands the “.F” suffix. Note that 
when using the C preprocessor, the 72 column convention is not followed. 

The -I option for specifying short integers has been changed to -i. The -I option is now 
used to specify directory search paths for “#include” statements. A -pg option for creating 
executable images which collect profiling information for gprof has been added. 

Is a font editor of dubious value. 

Now understands symbolic links. 

Has a new -type value, T, for finding symbolic links. 

Is a new compiler/interpreter for the Functional Programming language. A supporting docu- 
ment is present in Volume 2C of the UNIX Programmer’s Manual. 

Is a new program for printing Fortran files with embedded Fortran carriage controls. 

Is a new program for splitting a multi-function Fortran file into individual files. 

Is a new program which supports the ARPA standard File Transfer Protocol. 

Is a new program which creates a core dump of a running process. 

Is a new profiling tool which displays execution time for the dynamic call graph of a program. 
Gprof works on C, Fortran, and Pascal programs compiled with the -pg option. Gprof may 
also be used in creating a call graph profile for the operating system. A supporting document, 
“gprof: A Call Graph Execution Profiler" is included in Volume 2C of the UNIX Program- 
mer’s Manual. 

Is a new program which displays a user’s group access list. 

Is a new program which displays the system’s unique identifier as returned by the new geth- 
ostid system call. The super-user uses this program to set the host identifier at boot time. 

Is a new program which displays the system’s name as returned by the new gethostname sys- 
tem call. The super-user uses this program to set the host name at boot time. 

Is a new program for formatting C program source. 

Is a shell script used in installing software. 

Now reports kilobytes per second transferred for each disk. This is useful as the unit of infor- 
mation transferred is no longer a constant one kilobytes. 

Now displays the remote host from which a user logged in (when accessing a machine across 
a network). The pseudo user “ftp” may be specified to find out information about FTP file 
transfer sessions. 

Now displays flags for each command indicating if the program dumped core, used PDP-11 
mode, executed with a set-user-ID, or was created as the result of a fork (with no following 
exec). 

Now has lessons for vi (this is user contributed software which is not part of the standard sys- 
tem). 

Has a new -C flag for creating lint libraries from C source code. Has improved type check- 
ing on static variables. 

Has been ported to several 68000 UNIX systems, the relevant code is included in the distribu- 
tion. A new vector data type and a form of “closure” have been added. 

Has a new flag, -s, for creating symbolic links. 
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Has been extensively modified for use with the rlogind and telnetd network servers. 

Is totally new, see lpr. 

And its related programs are totally new. The line printer system supports multiple printers of 
many different characteristics. A master data base, /etc/printcap, describes both local printers 
and printers accessable across a network. A document describing the line printer system is 
now part of Volume 2C of the UNIX Programmer’s Manual. 

Is totally new, see lpr. 

Has been rewritten for the new directory format. It understands symbolic links and uses the 
new inode field which contains the actual number of blocks allocated to a file when the -s 
flag is supplied. Many rarely used options have been deleted. 

A bug which caused m4 to dump core when keywords were undefined then redefined has 
been fixed. 

Now supports mail folders in the style of the Rand MH system. Has been reworked to coop- 
erate with sendmail in understanding the new mail address formats. Allows users to defined 
message header fields which are not be displayed when a messages is viewed. Many other 
changes are described in a revised version of the user manual. 

Understands not to unlink directories when interrupted. Understands the new “.F” suffix for 
Fortran source files which are to be run through the C preprocessor. Has a new predefined 
macro MFLAGS which contains the flags supplied to make on the command line (useful in 
creating hierarchies of makefiles). 

Now uses the mkdir system call to run faster. 

Has a new command, status, which shows the current state of a tape drive. 

Has been rewritten to use the new rename system call. As a result, multiple directories may 
now be moved in a single command, the restrictions on having in a pathname are no 
longer present, and everything runs faster. 

And all related Berknet programs are no longer part of the standard distribution. These pro- 
grams live on in /usr/src/old for those who can not do without them. 

Is a new program which displays network statistics and active connections. 

No longer exists. 

Has gobs of new formats options. 

Is a new program which prints the system page size for use in constructing portable shell 
scripts. 

Now reliably interlocks with chsh, chfn, and vipw, in guarding against concurrent updates to 
the password file. 

For loops are now done according to the standard. Files may now be dynamically allocated 
and disposed. Records and variant records are now aligned to correspond to C structures and 
unions (this was falsely claimed before). Several obscure bugs involving formal routines have 
been fixed. Three new library routines support random access file i/o, see /usr/include/pascal 
for details. 

For loop variables and with pointers are now allocated to registers. Separate compilation 
type checking can now be done without reference to the source file; this permits movement 
(including distribution) of .o files and creation of libraries. Display entries are saved only 
when needed (a speed optimization). 

Is a new debugger for use with pi. Pdx is invoked automatically by the interpreter if a run- 
time error is encountered. Future work is planned to extend the new dbx debugger to under- 
stand code generated by the Pascal compiler pc. 

Has been changed to work with the new kernel and is no longer dependent on system page 
size. All process segment sizes are now shown in kilobytes. Understands that the old “using 
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new signal facilities” bit in the process structure now means “using old 4.1BSD signal facili- 
ties”. 

Now simply calls the getwd (3) routine. 

Is a new program for copying files across a network. The complete syntax of cp is supported, 
including recursive directory copying. 

Has had many bugs fixed in it and the associated -ms macro package support made to work. 

Now resets all the special characters to the system defaults specified in the include file 
<sy s/tty chars. h>. 

Is a new program for logging in to a machine across a network. Rlogin uses the files 
/etc/hosts. equiv and .rhosts in the users login directory to allow logins to be performed with- 
out a password. Rlogin supports proper handling of ~S/~Q and flushing of output when an 
interrupt is typed at the terminal. Its escape sequences are reminiscent of the old cu pro- 
gram (as it is based on the same source code). 

Now uses the rmdir system call to run more efficiently and not require root privileges. Unfor- 
tunately, this means arguments which end in one or more characters are no longer legal. 

Is a new program for running off bibiliographic databases. 

Is a new program which supports remote command execution across a network. 

Is a new program which displays system status information for clusters of machines attached 
to a local area network. 

Is a new program which displays users logged in on clusters of machines attached to a local 
area network. 

Has been rewritten to use pseudo-terminals. This allows the C shell job control facilities 
(among other things) to be used while scripting. A side effect of this change is that scripts 
now contain everything typed at a terminal. 

Has been replaced by dbx; it still lives on in /usr/src/old for those with a personal attachment. 

Is a new command for submitting bug reports on 4.2BSD in a standard format suitable for 
automatic filing by the bugfiler program. 

No longer has a newgrp command due to the new groups facilities. 

Is a new command for sorting bibliographic databases. 

Has been made blindingly fast by using the new truncate system call (thereby eliminating the 
old method of copying the file). 

The default system erase, kill, and interrupt characters have been made the DEC standard val- 
ues of DEL (“"?’), ‘TP, and ‘~C\ This is not expected to gain much popularity, but was done 
in the interest of compatibility with many other standard operating systems. 

Has been changed to do a “full login” when starting up the subshell. A new flag, -f, does a 
“fast” su for when a system is heavily loaded. Extra arguments supplied to su are now 
treated as a command line and executed directly instead of creating an interactive shell. 

Is a new program for maintaining system status information on terminals which support a 
“status line”; a poor man’s alternative to a window manager (or emacs). 

Has a larger buffer so that “tail — r” and similar show more. 

Is a new program which provides a screen-oriented write facility. Users may be “talked 
to”across a network, though satellite response times have indicated overseas conversations 
are still best done by phone. Can be very obnoxious when engaged in important work. 

Now allocates its internal buffers dynamically so that the block size can be specified to be 
very large for streaming tape drives. Also, now avoids many core-core copy operations. Has 
a new -C option for forcing chdir operations in the middle of operation (thereby allowing 
multiple disjoint subtrees to be easily placed in a single file, each with short relative path- 
names). Has a new flag, ‘B’, for forcing 20 block records to be read and written; useful in 
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joining two tar commands with a remote shell to transfer large amounts of data across a net- 
work. 

Is a new program which supports the ARPA standard Telnet protocol. 

Replaces cu as the standard mechanism for connecting to machines across a phone line or 
through a hardwired connection. Tip uses a database of system descriptions, supports many 
different auto-call units, and understands many nuances required to talk to non-UNIX sys- 
tems. Files may be transferred to and from non-UNIX systems in a simple fashion. 

A bug which sometimes caused an extra blank line to be printed after reaching end of file has 
been fixed. 

And related programs have been extensively enhanced to support many different auto-call 
units and multiple spooling directories (among other things). A large number of bugs and 
performance enhancements have been made. 

Is a new program which gives a snap-shot of the uucp spooling area. 

Is a program used to inspect and print information about fonts. 

Now uses a regular expression language to describe formatting. A -f flag forces vgrind to act 
as a filter, generating output suitable for inclusion in troff and/or nroff documents. Language 
descriptions exist for C, Pascal, Model, C shell, Bourne shell, Ratfor, and Icon programs. 

A bug which caused the ~B command to place the cursor on the wrong line has been fixed. A 
bug which caused vi to believe a file had been modified when an i/o error occurred has been 
fixed. A bug which allowed “hardtabs” to be set to 0 causing a divide by zero fault has been 
fixed. 

Is a new program for pretty printing Lisp programs. 

Has had one new piece of information added to -s summary, the number of fast page reclaims 
performed. The fields related to paging activity are now all given in kilobytes. 

And associated programs for spooling and printing files on Varian and Versatec printers are 
now shell scripts which use the new line printer support. 

Is a new program for making troff width tables for a font. 

Is once again identical to the version 7 program. That is, the -v, -t, -b, -s, and -u flags have 
been deleted. 

Understands the new directory organization for the source code. 

Now understands how to handle aliases. 

Now displays the remote machine from which a user is logged in. 

Section 2. 


The most important change in section 2 is that the documentation has been significantly improved. 
Manual page entries now indicate the possible error codes which may be returned and how to interpret 
them. The introduction to section 2 now includes a glossary of terms used throughout the section. The ter- 
minology and formatting have been made consistent. Many manual pages now have “NOTES” or 
“CAVEATS” providing useful information heretofore left out for the sake of brevity. As always the man- 
ual pages are still for the programmer; they are terse and extremely concise. The “4.2BSD System Man- 
ual” is likewise concise, but a bit more verbose in providing an overall picture of the system facilities. 

With regard to changes in the facilities, these fall into three major categories: interprocess communi- 
cation, signals, and file system related calls. The interprocess communication facilities center around the 
socket mechanism described in the “A 4.2BSD Interprocess Communication Primer”. The new signals do 
not have an accompanying document, so the manual pages should be studied carefully. The new file system 
calls pretty much stand on their own, with a late section of the document “A Fast File System for UNIX” 
supplying a quick overview of the most important new file system facilities. Finally, it should be noted that 
the job control facilities introduced in 4.1BSD have been adopted as a standard part of 4.2BSD. No special 
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distinction is given to these calls (in 4.1BSD they were earmarked “2J”). 

Many of the new system calls have both a “set” and a “get” form. Only the “get” forms are indi- 
cated below. Consult the manual for details on the “set” form. 

intro Has been updated to reflect the new list of possible error codes. Now includes a glossary of 

terminology used in section 2. 

access Now has symbolic definitions for the mode parameter defined in <sy s/file. h>. 

bind Is a new interprocess communication system call for binding names to sockets. 

connect Is a new interprocess communication system call for establishing a connection between two 
sockets. 

creat Has been obsoleted by the new open interface. 

fchmod Is a new system call which does a chmod operation given a file descriptor; useful in conjunc- 
tion with the new advisory locking facilities. 

fchown Is a new system call which does a chown operation given a file descriptor; useful in conjunc- 
tion with the new advisory locking facilities. 

fcntl Is a new system call which is useful in controlling how i/o is performed on a file descriptor 

(non-blocking i/o, signal drive i/o). This interface is compatible with the System III fcntl 
interface. 

flock Is a new system call for manipulating advisory locks on files. Locks may be shared or exclu- 

sive and locking operations may be indicated as being non-blocking, in which case a process 
is not blocked if the requested lock is currently in use. 

fstat Now returns a larger stat buffer; see below under stat. 

fsync Is a new system call for synchronizing a file’s in-core state with that on disk. Its intended use 

is in building transaction oriented facilities. 

ftruncate Is a new system call which does a truncate operation given a file descriptor; useful in con- 
junction with the new advisory locking facilities. 

getdtablesizels a new system call which returns the size of the descriptor table. 

getgroups Is a new system call which returns the group access list for the caller. 

gethostid Is a new system call which returns the unique (hopefully) identifier for the current host. 

gethostnamels a new system call which returns the name of the current host. 

getitimer Is a new system call which gets the current value for an interval timer. 

getpagesize Is a new system call which returns the system page size. 

getpriority Is a new system call which returns the current scheduling priority for a specific process, a 
group of processes, or all processes owned by a user. In the latter two cases, the priority 
returned is the highest (lowest numerical value) enjoyed by any of the specified processes. 

getrlimit Is a new system call which returns information about a resource limit. The getrlimit and setr- 
limit calls replace the old vlimit call from 4.1BSD. 

getrusage Is a new system call which returns information about resource utilitization of a child process 
or the caller. This call replaces the vtimes call of 4.1BSD. 

getsockopt Is a new interprocess communication system call which returns the current options present on 
a socket. 

gettimeofdayls a new system call which returns the current Greenwich date and time, and the current time- 
zone in which the machine is operating. Time is returned in seconds and microseconds since 
January 1, 1970. 

ioctl Has been changed to encode the size of parameters and whether they are to be copied in, out, 

or in and out of the user address space in the request. The symbolic names for the various 
ioctl requests remain the same, only the numeric values have changed. A number of new 
ioctls exist for use with sockets and the network facilities. The old LINTRUP request has 
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been replaced by a call to fcntl and the SIGIO signal. 

Has now been made a system call; in 4.1 BSD it was a library routine. 

Is a new interprocess communication system call used to indicate a socket will be used to lis- 
ten for incoming connection requests. 

Now has symbolic definitions for its whence parameter defined in <sys/file.h>. 

Is a new system call which creates a directory. 

The multiplexed file facilities are no longer part of the system. They have been replaced by 
the socket, and related, system calls. 

Is different, now taking an optional third parameter and supporting file creation, automatic 
truncation, automatic append on write, and “exclusive” opens. The open interface has been 
made compatible with System III with the exception that non-blocking opens on terminal 
lines requiring carrier are not supported. 

Now returns statistical information based on a 100 hz clock rate. 

Is a new system call which is part of the disk quota facilities. Quota is used to manipulate 
disk quotas for a specific user, as well as perform certain random chores such as syncing quo- 
tas to disk. 

Now automatically restarts when a read on a terminal is interrupted by a signal before any 
data is read. 

Is a new system call which supports scattering of read data into (possibly) disjoint areas of 
memory. 

Is a new system call for reading the value of a symbolic link. 

Is a new interprocess communication system call used to receive a message on a connected 
socket. 

Is a new interprocess communication system call used to receive a message on a (possibly) 
unconnected socket. 

Is a new interprocess communication system call used to receive a message on a (possibly) 
unconnected socket which may have access rights included. When using on-machine com- 
munication, recvmsg and sendmsg may be used to pass file descriptors between processes. 

Is a new system call which changes the name of an entry in the file system (plain file, direc- 
tory, character special file, etc.). Rename has an important property in that it guarantees the 
target will always exist, even if the system crashes in the middle of the operation. Rename 
only works with source and destination in the same file system. 

Is a new system call for removing a directory. 

Is a new system call (mainly for interprocess communication) which provides facility for syn- 
chronous i/o multiplexing. Sets of file descriptors may be queried for readability, writability, 
and if any exceptional conditions are present (such as out of band data on a socket). An 
optional timeout may also be supplied in which case the select operation will return after a 
specified period of time should no descriptor satisfy the requests. 

Is a new interprocess communication system call for sending a message on a connected 
socket. 

Is a new interprocess communication system call for sending a message on a (possibly) 
unconnected socket. 

Is a new interprocess communication system call for sending a message on a (possibly) 
unconnected socket which may included access rights. 

Is a new system call for enabling or disabling disk quotas on a file system. 

Is a new system call which replaces the 4.1BSD setgid system call. Setregid allows the real 
and effective group ID’s of a process to be set separately. 
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Is a new system call which replaces the 4.1BSD setuid system call. Setreuid allows the real 
and effective user ID’s of a process to be set separately. 

Is a new interprocess communication system call for shutting down part or all of full-duplex 
connection. 

Is a new system call for blocking signals during a critical section of code. 

Is a new system call for blocking a set of signals and then pausing indefinitely for a signal to 
arrive. 

Is a new system call for setting the set of signals which are currently blocked from delivery to 
a process. 

Is a new system call for defining an alternate stack on which signals are to be processed. 

Is no longer supported. The new signal facilities are a superset of those which sigsys pro- 
vided. 

Is the new system call interface for defining signal actions. For each signal (except SIGSTOP 
and SIGKILL), sigvec allows a “signal vector” to be defined. The signal vector is comprised 
of a handler, a mask of signals to be blocked while the handler executes, and an indication of 
whether or not the handler should execute on a signal stack defined by a sigstack call. The 
old signal interface is provided as a library routine with several important caveats. First, sig- 
nal actions are no longer reset to their default value after a signal is delivered to a process. 
Second, while a signal handler is executing the signal which is being processed is blocked 
until the handler returns. To simulate the old signal interface, the user must explicitly reset 
the signal action to be the default value and unblock the signal being processed. 

Four new signals have been added for the interprocess communication and interval timer 
facilities. SIGIO is delivered to a process when an fcntl call enables signal driven i/o and 
input is present on a terminal (and a signal handler is defined). SIGURG is delivered when an 
urgent condition arises on a socket (and a handler is defined). SIGPROF and SIGVTALRM 
are associated with the ITIMER_PROF and ITIMER_VIRTUAL interval timers, and deliv- 
ered to a process when such a timer expires (the SIGALRM signal is used for the 
ITIMER_REAL interval timer). The old SIGTINT signal is replaced by SIGIO. 

Is a new interprocess communication system call for creating a socket. 

Is a new interprocess communication system call for creating a pair of connected and 
unnamed sockets. 

Now returns a larger structure. New fields are present indicating the optimal blocking factor 
in which i/o should be performed (for disk files the block size of the underlying file system) 
and the actual number of disk blocks allocated to the file. Inode numbers are now 32-bit 
quantities. Several spare fields have been allocated for future expansion. These include space 
for 64-bit file sizes and 64-bit time stamps. Two new file types may be returned, SJ1FLNK 
for symbolic links, and SJFSOCK for sockets residing in the file system. 

Has been renamed from the vswapon call of 4.1BSD. 

Is a new system call for creating a symbolic link. 

Is a new system call for truncating a file to a specific size. 

Should no longer be used for removing directories. Directories should only be created with 
mkdir and removed with rmdir. Creating hard links to directories can cause disastrous results. 

Is defunct, replaced by utimes. 

Is a new system call which uses the new time format in setting the accessed and updated times 
on a file. 

Is still present, but definitely on its way out. Future plans include implementing fork with a 
scheme in which pages are initially shared read-only. On the first attempt by a process to 
write on a page the parent and child would receive separate writable copies of the page. 
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vlimit 

vread 

vswapon 

vtimes 

vwrite 

wait 

wait3 


write 

writev 


Is no longer supported. Vlimit is replaced by the getrlimit and setrlimit calls. 

Is no longer supported in the system. 

Has been renamed swapon. 

Is no longer supported. Vtimes is replaced by the getrusage call. 

Is no longer supported in the system. 

Now is automatically restarted when interrupted by a signal before status could be returned. 

Returns resource usage in a different format than that which was returned in 4.1BSD. This 
structure is compatible with the new getrusage system call. Wait3 is now automatically 
restarted when interrupted by a signal before status could be returned. 

Now is automatically restarted when writing on a terminal and interrupted by a signal before 
any i/o was completed. 

Is a new version of the write system call which supports gathering of data in (possibly) dis- 
contiguous areas of memory 


Section 3 


The section 3 documentation has been reorganized to group manual entries by library. Introductory 
sections for each logical and physical library contain lists of the entry points in the library. 

A number of routines which had been system calls under 4.1BSD are now user-level library routines 
in 4.2BSD. These routines have been grouped under section “3C” headings, “C” for compatibility. Fur- 
ther, certain routines present in the standard C run-time library which do not easily categorize as part of one 
of the standard libraries, have been group under “3X” headings. 


curses 

stdio 


bstring 

ctime 

isprint 

directory 

getpass 

getwd 


A number of bug fixes have been incorporated, and the documentation has been revised. 

The standard i/o library has been modified to block i/o operations to disk files according to 
the block size of the underlying file system. This is accomplished using the new st_blksize 
value returned by fstat. The resultant performance improvement is significant as the old 1 
kilobyte buffer size often resulted in 7 memory-to-memory copy operations by the system on 
8 kilobyte block file systems. 

End-of-file marks now “stick”. That is, all input requests on a stdio channel after encounter- 
ing end-of-file will return end-of-file until a clearerr call is made. This has implications for 
programs which use stdio to read from a terminal and do not process end-of-file as a terminat- 
ing keystroke. 

Two new functions may be used to control i/o buffering. The setlinebuf routine is used to 
change stdout or stderr from block buffered or unbuffered to line buffered. The setbuffer 
routine is an alternate form of setbuf which can be used after a stream has been opened, but 
before it is read or written. 

Three new routines, bcmp , bcopy, and bzero have been added to the library. These routines 
use the VAX string instructions to manipulate binary byte strings of a known size. 

Now uses the gettimeofday system call and supports time conversion in six different time 
zones. Daylight savings calculations are also performed in each time zone when appropriate. 

Now considers space a printing character; as the manual page has always indicated. 

Is a new directory interface package which provides a portable interface to reading directo- 
ries. A version of this library which operates under 4.1BSD is also available. 

Now properly handles being unable to open /dev/tty. 

Has been moved from the old jobs library to the standard C run-time library. It now returns 
an error string rather than printing on the standard error when unable to decipher the current 
working directory. 
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Now uses the writev system call to pass all its arguments to the system in a single system call. 
This has profound effects on programs which transmit error messages across a network. 

And sys_siglist are routines for printing signal names in an equivalent manner to perror. 

Has been greatly sped up by choosing a random element with which to apply its divide and 
conquer algorithm. 

Is a successor to rand which generates much better random numbers. The old rand routine is 
still available and most programs have not been switched over to random as doing so would 
make certain facilities such encrypted mail unable to operate on existing data files. 

And longjmp now save and restore the signal mask so that non-local exit from a signal han- 
dler is transparent. The old semantics are available with _setjmp and _longjmp. 

Is a new set of routines for accessing database files for the DARPA Internet. Four databases 
exist: one for host names, one for network names, one for protocol numbers, and one for net- 
work services. The latter returns an Internet port and protocol to be used in accessing a given 
network service. 

An additional collection of routines, all prefaced with “inet_” may be used to manipulate 
Internet addresses, and interpret and convert between Internet addresses and ASCII represen- 
tations in the Internet standard “dot” notation. 

Finally, routines are available for converting 16 and 32 bit quantities between host and net- 
work order (on high-ender machines these routines are defined to be noops). 

The routines for manipulating /etc/fstab have been rewritten to return arbitrary length null-ter- 
minated strings. 

Section 4 

The system now supports the 1 1/730, the new 64Kbit RAM memory controllers for the 1 1/750 and 
11/780, and the second UNIBUS adapter for the 11/750. Several new character and/or block device drivers 
have been added, as well as support for many hardware devices which are accessible only through the net- 
work facilities. Each new piece of hardware supported is listed below. 

New manual entries in section 4 have been created to describe communications protocols, and net- 
work architectures supported. At present the only network architecture fully supported is the DARPA Inter- 
net with the TCP, IP, UDP, and ICMP protocols. 

acc A network driver for the ACC LH/DH IMP interface, 

ad A driver for the Data Translation A/D converter. 

arp The Address Resolution Protocol for dynamically mapping betwee 32-bit DARPA Internet 

addresses and 48-bit Xerox lOMb/s Ethernet addresses. 

css A network driver for the DEC IMP- 1 1 A LH/DH IMP interface. 

dmc A network interface driver for the DEC DMC-ll/DMR-11 point-to-point communications 

device. 

ec A network interface driver for the 3Com lOMb/s Ethernet controller, 

en A network interface driver for the Xerox 3Mb/s experimental Ethernet controller, 

hy A network interface driver for the Network Systems Hyperchannel Adapter, 

ik A driver for an Ikonas frame buffer graphics device interface, 

il A network interface driver for the Interlan lOMb/s Ethernet interface. 

imp A network interface driver for the standard 1822 interface to an IMP; used in conjunction 

with either acc or css hardware. 

kg A driver for a KL-1 1/DL-l 1W used as an alternate real time clock source for gathering kernel 

statistics and profiling information. 


perror 

psignal 

qsort 

random 

setjmp 

net 


fstab 
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lo 

pci 

ps 

pty 

rx 

ts 

tu 


uda 

un 

up 

uu 

va 

vv 


dir 

disktab 

dump 

fs 

gettytab 

hosts 

mtab 

networks 

phones 

printcap 

protocols 

remote 

services 


tar 

utmp 


A software loopback network interface for protocol testing and performance analysis. 

A network interface driver for the DEC PCL-1 IB communications controller. 

A driver for an Evans and Sutherland Picture System 2 graphics device connected with a 
DMA interface. 

Now includes a simple packet protocol to support flow controlled operation with mechanisms 
for flushing data to be read and/or written. 

A driver for the DEC dual RX02 floppy disk unit. 

Now supports TU80 tape drives. 

The VAX- 11/750 console cassette interface has been made somewhat usable when operating 
in single-user mode. The device driver employs assembly language pseudo-dma code for the 
reception of incoming packets from the cassette. 

Now supports RA81, RA80, and RA60 disk drives. 

A network interface driver for an Ungermann-Bass network interface unit connected to the 
host via a DR-11W. 

Now supports ECC correction and bad sector handling. Also has improved logic for recog- 
nizing many different kinds of disk drives automatically at boot time. 

A driver for DEC dual TU58 tape cartridges connected via a DL-1 1W interface. 

The Varian driver has been rewritten so that it may coexist on the same UNIBUS with devices 
which require exclusive use of the bus; i.e. RK07’s. 

A network interface driver for the Proteon proNET lOMb/s ring network controller. 

Section 5 


Reflects the new directory format. 

Is a new file for maintaining disk geometry information. This is a temporary scheme until the 
information stored in this file for each disk is recorded on the disk pack itself. 

Is a superset of that used in 4.1BSD. 

Reflects the new file system organization. 

Is a new file which idescribes terminal characteristics. Each entry in the file describes one of 
the possible arguments to the getty program. 

Is a database for mapping between host names and DARPA Internet host addresses. 

Has been modified to include a “type” field indicating whether the file system is mounted 
read-only, read-write, or read-write with disk quotas enabled. 

Is a database for mapping between network names and DARPA standard network numbers. 

Is a phone number data base for tip. 

Is a termcap clone for configuring printers. 

Is a database for mapping between protocol names and DARPA Internetwork standard proto- 
col numbers. 

Is a database of remote hosts for use with tip. 

Is a database in which DARPA Internet services are recorded. The information contained in 
this file indicates the name of the service, the protocol which is required to access it, and the 
port number at which a client should connect to utilize the service. 

Is a new entry describing the format of a tar tape. 

Has been augmented to include a remote host from which a login session originates. The 
wtmp file is also used to record FTP sessions. 
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vgrindefs Is a file describing how to vgrind programs written in many languages. 

Section 6 

aardvark Does not work because it requires the “Dungeon Definition Language” processor which is a 
binary image requiring 4.1BSD compatibility mode; the DDL source is still present. 

aliens The aliens have returned home, the game is no longer included in the distribution. 

backgammonls now screen oriented. A new program, teachgammon, instructs the new backgammon 
player. The old version is now called btlgammon. 

canfield Is a new game which plays a brand of the popular game of solitaire. Betting is included, the 
program cfscores may be used to find out your current debt. 

ching Now pipes its output through more. Thus the hacker placates the seekers, 

chase No longer exists because the binary does not work under 4.2BSD. 

factor Is a rewrite in C of the old version 7 assembly language program which finds the prime fac- 
tors of a number. 

fortune Has yet more adages, 

hangman Is now screen oriented, 

mille Now plays more intelligently. 

primes Is a rewrite in C of the old version 7 assembly language program which finds prime numbers 
within a specified range. 

rogue Has been made more of a scoundrel. The supplementary document “A Guide to the Dun- 

geons of Doom”, has been updated as well, and is now part of Volume 2C of the program- 
mer’s manual. 

sail Is a new game which simulates sea battles of yore. The manual page is large enough to be a 

separate document and so has been left in its source directory. 

trek The original trek has returned; trekies rejoice. 

Section 7 

Has been updated to reflect the reorganization to the user and system source. 

Is a new entry describing mail addressing syntax under sendmail (possibly too Berkeley spe- 
cific). 

The -ms macros have been extended to allow automatic creation of a table of contents. Sup- 
port for the refer preprocessor is improved. Several bugs related to multi-column output and 
floating keeps have been fixed. Extensions to the accent mark string set are available by 
including the .AM macro. Footnotes can now be automatically numbered (in superscript) by 
-ms and referenced in the text with a \** string register. The manual page includes a sum- 
mary of important number and string registers. A new document “Changes to -ms” is 
included in Volume 2C of the programmer’s manual. 

Section 8 

Major changes affecting system operations include: 

• The system now supports disk quotas. These allow system administrators to control users’ disk space 
and file allocation on a per-file system basis. Utilities in this section exist for fixing, summarizing, and 
editing disk quota summary files. 

• File systems are now made with a new program, newfs, which acts as front end to the old mkfs pro- 
gram. There no longer is a need to remember disk partition sizes, as newfs gets this information auto- 
matically from the /etc/disktab file. In addition, newfs attempts to lay out file systems according to the 


hier 

mailaddr 
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characteristics of the underlying disk drive (taking into account disk geometry information). 

• DEC standard bad block forwarding is now supported on the RP06 and second vendor UNIBUS storage 
module disks. The badl44 program can now be used to mark sectors bad on many disks, though inclu- 
sion in the bad sector table is still somewhat risky due to requirements in the ordering of entries in the 
table. 

• A new program, format, should be used to initialize all non-DEC storage modules before creating file 
systems. Format formats the sector headers and creates a bad sector table which is used in normal sys- 
tem operation. Format runs in a standalone mode. 

• Getty has been rewritten to use a description file, /etc/gettytab. This allows sites to tailor terminal oper- 
ation and configuration without making modifications to getty. 

• The line printer system is totally new. A program to administer the operation of printers, lpc, is sup- 
plied, and printer accounting has been consolidated into a single program, pac. 

• The program used to restore files from dump tapes is now called restore. This name change was done 
to reinforce the fact that it is completely rewritten and operates in a very different way than the old 
restor program. Restore operates on mounted file systems and uses only normal file system operations 
to restore files. Versions of both dump and restore which operate across a network are included as 
rdump and rrestore. Dump and restore (and their network oriented counterparts) now perform so effi- 
ciently (mostly because of the new file system), that disk to disk backups should no longer be an attrac- 
tive alternative. 


arff 
bad 144 

badsect 

bugfiler 

chgrp 

comsat 

config 

diskpart 

drtest 

dump 

dumpfs 


No longer asks if you want to clobber the floppy when manipulating archives which are not 
on the floppy. 

Has been modified to use the /etc/disktab file. Can be used to create bad sector tables for the 
DEC RP06 and several new Winchester disk drives. Consult the source code for details and 
use with extreme care. 

Has been modified to work with the new file system and now must interact with fsck to per- 
form its duties. Consult the manual page for more information. 

Is a new program for automatic filing and acknowledgement of bug reports submitted by the 
sendbug program. Intended to operate with the Rand MH software which is part of the user 
contributed software. Used at Berkeley to process bug reports on 4.2BSD. 

Has been moved to section 1. 

Has been changed to filter the noise lines in message headers when displaying incoming mail. 
No longer uses a second process watchdog as it uses the more reliable socket facilities instead 
of the old mpx facilities. 

Has been extensively modified to handle the new root and swap device specification syntax. 
A new document, “Configuring 4.2BSD UNIX Systems with Config”, describes its use, as 
well as other important information needed in configuring system images; this is part of Vol- 
ume 2C of the programmer’s manual. 

Is a new program which may be used to generate disk partition tables according to the rules 
used at Berkeley. Can automatically generate entries required for device drivers and for the 
/etc/diskpart file. (Does not handle the new DEC DSA style drives properly because it tries to 
reserve space for the bad sector table.) 

Is a new standalone program which is useful in testing standalone disk device drivers and for 
pinpointing bad sectors on a disk. 

Has been modified for the new file system organization. Mainly due to the new file system, it 
runs virtually at tape speed. Properly handles locking on the dumpdates file when multiple 
dumps are performed concurrently on the same machine. 

Is a new program for dumping out information about a file system such as the block size and 
disk layout information. 
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edquota 

fastboot 

fasthalt 

format 

fsck 

ftpd 

gettable 

getty 

icheck 

init 

kgmon 

Ipc 

lpd 

MAKEDEV 

mkfs 

mount 

newfs 

pac 

quot 

quotacheck 


Is a new program for editing user quotas. Operates by invoking your favorite editor on an 
ASCII representation of the information stored in the binary quota files. Edquota also has a 
“replication” mode whereby a quota template may be used to create quotas for a group of 
users. 

Is a new shell script which reboots the system without checking the file systems; should be 
used with extreme care. 

Is a new script which is similar to fastboot. 

Is a new standalone program for formatting non-DEC storage modules and creating the 
appropriate bad sector table on the disk. 

Has been changed for the new file system. Fsck is more paranoid then ever in checking the 
disks, and has been sped up significantly. The accompanying Volume 2C document has been 
updated to reflect the new file system organization. 

Is the DARPA File Transfer Protocol server program. It supports C shell style globbing of 
arguments and a large set of the commands in the specification (except the ABORT com- 
mand!). 

Is a new program which can be used in aquiring up to date DARPA Internet host database 
files. 

Has been rewritten to use a terminal description database, /etc/gettytab. Consult the manual 
entries for getty (8) and gettytab (5) for more information. 

Has been modified for the new file system. 

Has been significantly modified to use the new signal facilities. In doing so, several race con- 
ditions related to signal delivery have been fixed. 

Is a new program for controlling running systems which have been created with kernel profil- 
ing. Using kgmon, profiling can be turned on or off and internal profiling buffers can dumped 
into a gmon.out file suiitable for interpretation by gprof. 

Is a new program controlling line printers and their associated spooling queues. Lpc can be 
used to enable and disable printers and/or their spooling queues. Lpc can also be used to rear- 
range existing jobs in a queue. 

Has been rewritten and now runs as a “server”, using the interprocess communication facili- 
ties to service print requests. A supplementary document describing the line printer system is 
now part of Volume 2C of the programmer’s manual. 

Is a new shell script which resides in /dev and is used to create special files there. 
MAKEDEV keeps commands for creating and manipulating local devices in a separate file 
MAKEDEV.local. 

Has been virtually rewritten for the new file system. The arguments supplied are very differ- 
ent. For the most part, users now use the newfs program when creating file systems. Mkfs 
now automatically creates the lost+found directory. 

Now indicates file systems which are mounted read-only or have disk quotas enabled. 

Is a new front-end to the mkfs program. Newfs figures out the appropriate parameters to sup- 
ply to mkfs, invokes it, and then, if necessary, installs the boot blocks necessary to bootstrap 
UNIX on 11/750’s. 

Is a new program which can be used to do printer accounting on any printer. It subsumes the 
vpac program. 

Now uses the information in the inode of each file to find out how many blocks are allocated 
to it. 

Is a new program which performs consistency checks on disk quota files. Quotacheck is nor- 
mally run from the /etc/rc.local file after a system is rebooted, though it can also be run on 
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quotaon 

pstat 

rc 

rdump 

renice 

rep quota 

restor 

restore 


rexecd 

rlogind 

rmt 

route 

routed 

rrestore 

rshd 

rwhod 

rxformat 

savecore 

sendmail 


setifaddr 

syslog 

telnetd 

tftpd 

trpt 

tunefs 

vipw 


mounted on file systems which are not in use. 

Is a new program which enables disk quotas on file systems. A link to quotaon, named quo- 
taoff, is used to disable disk quotas on file systems. 

Has been modified to understand new kernel data structures. 

Has had system dependent startup commands moved to /etc/rc. local. 

Is a new program to dump file systems across a network. 

Has been rewritten to use the new setpriority system call. As a result, you can now renice 
users and process groups. 

Is a new program which summarizes disk quotas on one or more file systems. 

No longer exists. A new program, restore, is its successor. 

Replaces restor. Restore operates on mounted file systems; it contains an interactive mode 
and can be used to restore files by name. Restore has become almost as flexible to use as tar 
in retrieving files from tape. 

Is a network server for the rexec (3X) library routine. Supports remote command execution 
where authentication is performed using user accounts and passwords. 

Is a network server for the rlogin( 1C) command. Supports remote login sessions where 
authentication is performed using privileged port numbers and two files, /etc/hosts. equiv and 
.rhosts (in each users home directory). 

Is a program used by rrestore and rdump for doing remote tape operations. 

Is a program for manually manipulating network routing tables. 

Is a routing daemon which uses a variant of the Xerox Routing Information Protocol to auto- 
matically maintain up to date routing tables. 

Is a version of restore which works across a network. 

Is a server for the rsh (1C) command. It supports remote command execution using privi- 
leged port numbers and the /etc/hosts. equiv and .rhosts files in users’ home directories. 

Is a server which generates and listens for host status information on local networks. The 
information stored by rwhod is used by the rwho (1C) and ruptime (1C) programs. 

Is a program for formatting floppy disks (this uses the rx device driver, not the console floppy 
interface). 

Has been modified to get many pieces of information from the running system and crash 
dump to avoid compiled in constants. 

Is a new program replacing delivermail; it provides fully internetwork mail forwarding capa- 
bilities. Sendmail uses the DARPA standard SMTP protocol to send and receive mail. Send- 
mail uses a configuration file to control its operation, eliminating the compiled in description 
used in delivermail. 

Is a new program used to set a network interface’s address. Calls to this program are nor- 
mally placed in the /etc/rc. local file to configure the network hardware present on a machine. 

Is a server which receives system logging messages. Currently, only the sendmail program 
uses this server. 

Is a server for the DARPA standard TELNET protocol. 

Is a server for the DARPA Trivial File Transfer Protocol. 

Is a program used in debugging TCP. Trpt transliterates protocol trace information recorded 
by TCP in a circular buffer in kernel memory. 

Is a program for modifying certain parameters in the super block of file systems. 

Is no longer a shell script and properly interacts with passwd, chsh, and chfn in locking the 
password file. 



